home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / nrm2.z / nrm2
Encoding:
Text File  |  2002-10-03  |  2.9 KB  |  86 lines
  1. NRM2(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSNNRRMM22, DDNNRRMM22, SSCCNNRRMM22, DDZZNNRRMM22 - Computes the Euclidean norm of a vector
  6.  
  7. SSYYNNOOPPSSIISS
  8.      Real
  9.  
  10.         _e_n_r_m == SSNNRRMM22 ((_n,, _x,, _i_n_c_x))
  11.  
  12.      Double precision
  13.  
  14.         _e_n_r_m == DDNNRRMM22 ((_n,, _x_i,, _i_n_c_x))
  15.  
  16.      Complex
  17.  
  18.         _e_n_r_m == SSCCNNRRMM22 ((_n,, _x,, _i_n_c_x))
  19.  
  20.      Double complex
  21.  
  22.         _e_n_r_m == DDZZNNRRMM22 ((_n,, _x_i,, _i_n_c_x))
  23.  
  24. IIMMPPLLEEMMEENNTTAATTIIOONN
  25.      IRIX systems
  26.  
  27. DDEESSCCRRIIPPTTIIOONN
  28.      SSNNRRMM22/DDNNRRMM22 computes the Euclidean (_l ) norm of a real vector, as
  29.      follows:                             _2
  30.  
  31.           enrm <- ||x||  =
  32.                        2
  33.                  T            n      2
  34.           sqrt (x x) = sqrt (Sum * x  )
  35.                              i=1    i
  36.  
  37.                                     _T
  38.      where _x is a real vector, and _x  denotes the transpose of _x.
  39.  
  40.      SSCCNNRRMM22/DDZZNNRRMM22 computes the Euclidean (_l ) norm of a complex vector, as
  41.      follows:                               _2
  42.  
  43.           enrm <- ||x||  =
  44.                        2
  45.                  H            n  _
  46.           sqrt (x x) = sqrt (Sum x x )
  47.                              i=1  i i
  48.                                        _H
  49.      where _x is a complex vector, and _x  denotes the conjugate transpose of
  50.      _x.
  51.  
  52.      These functions have the following arguments:
  53.  
  54.      _e_n_r_m      Result.  (output)
  55.                SSNNRRMM22: Real result.
  56.                DDNNRRMM22: Double precision result.
  57.                SSCCNNRRMM22: Real result.
  58.                DDZZNNRRMM22:  Double precision result.
  59.                Result (Euclidean norm).  If _n <= 0, _e_n_r_m is set to 0.
  60.  
  61.      _n         Integer.  (input)
  62.                Number of elements in the operand vector.
  63.  
  64.      _x         Array of dimension (_n-1) * |_i_n_c_x| + 1.  (input)
  65.                SSNNRRMM22: Real array.
  66.                DDNNRRMM22: Double precision array.
  67.                SSCCNNRRMM22: Complex array.
  68.                DDZZNNRRMM22:  Double complex array.
  69.                Array _x contains the operand vector.
  70.  
  71.      _i_n_c_x      Integer.  (input)
  72.                Increment between elements of _x.  If _i_n_c_x = 0, the results
  73.                will be unpredictable.
  74.  
  75. NNOOTTEESS
  76.      These routines are Level 1 Basic Linear Algebra Subprograms (Level 1
  77.      BLAS).
  78.  
  79.      When working backward (_i_n_c_x < 0), each routine starts at the end of
  80.      the vector and moves backward, as follows:
  81.  
  82.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  83.  
  84. SSEEEE AALLSSOO
  85.      This man page is available only online.
  86.